Preconfiguration Requirements for Non-US Keyboards

Eggplant Test's Remote Desktop Protocol (RDP) connections are able to help to perform keyboard layout synchronization between the Eggplant Test client machine (the machine running EPF, DAI, or Eggplant Gateway) with the system under test (SUT). For example, if a client machine is using a Japanese Keyboard, after the RDP connection is established, the SUT keyboard will also be set as Japanese Keyboard.

Due to this behavior, some pre-configuration steps may be required to ensure proper keyboard mapping and functionality during remote sessions.

Support for RDP SUTs with Non-US keyboards

The SUT will only reflect the correct keyboard layout if the previous RDP session has been disconnected and properly signed off.

Important

If the previous session is disconnected but not signed off, the keyboard layout may not update correctly in the new session.

Root Cause

The issue arises because the keyboard layout synchronization depends on the state of the previous RDP session. If the session is disconnected without signing off, the SUT retains the previous keyboard layout settings.

Pre-configuration Steps

1. Start the RDP session with your desired keyboard layout. (Or, using the RDP session that was previously started.)
2. If you later need to switch to a different keyboard layout, you must first sign off from the current RDP session.
3. Avoid only disconnecting the session, as this will retain the previous keyboard layout in the next session.
4. After signing off, initiate a new Eggplant Test client RDP session/connection with the new keyboard layout.
5. Verify that the new layout is correctly applied in the session.

Affected Scenarios

This issue is commonly observed in environments using RDP or similar remote access technologies, where multiple sessions are initiated without proper sign-off. It affects users who rely on specific keyboard layouts for their work, leading to potential disruptions and inefficiencies.